package com.bookstore.back.service;

import java.util.List;

/**
 * 畅销榜单定时更新服务接口
 * 
 * @author 程序猿_Ti
 * @since 2025-07-22
 */
public interface BestsellerScheduleService {

    /**
     * 自动生成畅销榜单
     * 根据图书销量数据自动生成不同分类和周期的畅销榜单
     */
    void generateBestsellerRankings();
    
    /**
     * 生成综合畅销榜单
     * 
     * @param period 统计周期：daily-日榜 weekly-周榜 monthly-月榜
     * @param limit 榜单数量限制
     */
    void generateOverallRanking(String period, int limit);
    
    /**
     * 生成分类畅销榜单
     * 
     * @param categoryId 分类ID
     * @param period 统计周期：daily-日榜 weekly-周榜 monthly-月榜
     * @param limit 榜单数量限制
     */
    void generateCategoryRanking(Integer categoryId, String period, int limit);
    
    /**
     * 清理过期的榜单数据
     * 
     * @param period 统计周期
     */
    void cleanExpiredRankings(String period);
    
}
